home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_hylafax.idb / usr / freeware / man / cat1 / faxcron.Z / faxcron
Encoding:
Text File  |  1999-07-16  |  5.2 KB  |  132 lines
  1.  
  2.  
  3.  
  4. FFFFAAAAXXXXCCCCRRRROOOONNNN((((1111MMMM))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666))))        FFFFAAAAXXXXCCCCRRRROOOONNNN((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      faxcron - _H_y_l_a_F_A_X routine maintenance script
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////ssssbbbbiiiinnnn////ffffaaaaxxxxccccrrrroooonnnn [ ----nnnn ] [ ----llll _l_a_s_t_r_u_n ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ffffaaaaxxxxccccrrrroooonnnn is a command script that does routine upkeep tasks
  16.      in a _H_y_l_a_F_A_X spooling directory hierarchy.  This script is
  17.      intended to be invoked from _c_r_o_n(1M) on behalf of the fax
  18.      user once a day, with the standard output sent by mail to
  19.      the _H_y_l_a_F_A_X administrator.  For example, the following
  20.      crontab might be setup for the fax user:
  21.        25   23    *    *    *   sh /usr/freeware/sbin/faxcron | mail FaxMaster
  22.  
  23.      The _f_a_x_c_r_o_n script does the following work:
  24.  
  25.      +o  report statistics for facsimile transmitted since the
  26.         last time _f_a_x_c_r_o_n was run.
  27.  
  28.      +o  report statistics for facsimile transmitted in the past
  29.         week.
  30.  
  31.      +o  report statistics for facsimile received since the last
  32.         time _f_a_x_c_r_o_n was run.
  33.  
  34.      +o  report statistics for facsimile received in the past
  35.         week.
  36.  
  37.      +o  report any recent calls that failed suspiciously and
  38.         return the associated trace log;
  39.  
  40.      +o  purge data that is 30 days or older from the remote
  41.         machine information directory;
  42.  
  43.      +o  delete information that is 30 days or older from session
  44.         trace log files;
  45.  
  46.      +o  remove files from the tmp directory that are older than 1
  47.         day;
  48.  
  49.      +o  remove received facsimile that are 7 days or older;
  50.  
  51.      +o  report sites that are currently having jobs rejected; and
  52.  
  53.      +o  force all session log files to be owned by the fax user
  54.         and kept with protection mode 644.
  55.  
  56. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  57.      ----nnnn        Forces _f_a_x_c_r_o_n to run without updating any files.
  58.  
  60.  
  61.  
  62. Page 1                                          (printed 6/24/99)
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. FFFFAAAAXXXXCCCCRRRROOOONNNN((((1111MMMM))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666))))        FFFFAAAAXXXXCCCCRRRROOOONNNN((((1111MMMM))))
  70.  
  71.  
  72.  
  73.      ----llll _l_a_s_t_r_u_n
  74.                Forces the notion of the last time that _f_a_x_c_r_o_n
  75.                was run to be _l_a_s_t_r_u_n.  The value of _l_a_s_t_r_u_n is a
  76.                date and time string of the form ``MM/DD/YY
  77.                HH:MM'' (the _d_a_t_e(1) format string ``%D %H:%M'').
  78.  
  79.      ----iiiinnnnffffoooo _n   Set the expiration time for data in the info
  80.                database to be _n days.
  81.  
  82.      ----lllloooogggg _n    Set the expiration time for session log data to be
  83.                _n days.
  84.  
  85.      ----rrrrccccvvvv _n    Set the expiration time for files in the received
  86.                facsimile queue to be _n days.
  87.  
  88.      ----ttttmmmmpppp _n    Set the expiration time for files in the tmp
  89.                directory to be _n days.
  90.  
  91.      ----mmmmooooddddeeee _m   Set the file protection mode for session logs to _m
  92.                (a command line argument to _c_h_m_o_d(1)).
  93.  
  94. NNNNOOOOTTTTEEEESSSS
  95.      This script requires _n_a_w_k(1) or _g_a_w_k(1) and a _d_a_t_e (_1)
  96.      program that supports the ``+format'' option.
  97.  
  98.      If session logs are to be kept private this script must be
  99.      modified to filter out sensitive information such as calling
  100.      card numbers.  (It should also be run with ``-mode 0600'' so
  101.      that session log files are not publicly readable.)
  102.  
  103. FFFFIIIILLLLEEEESSSS
  104.      /usr/freeware/var/spool/fax                  spooling area
  105.      /usr/freeware/var/spool/fax/etc/lastrun      timestamp of last run
  106.      /usr/freeware/sbin/xferstats                 for generating transmit statistics
  107.      /usr/freeware/sbin/recvstats                 for generating receive statistics
  108.      /tmp/faxcronXXXX                             temporary file for truncating session logs
  109.      /tmp/faxlogXXXX                              temporary file for logs of failed calls
  110.  
  111. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  112.      _c_r_o_n(1M), _f_a_x_q(1M), _f_a_x_g_e_t_t_y(1M), _f_a_x_s_e_n_d(1M),
  113.      _x_f_e_r_s_t_a_t_s(1M), _r_e_c_v_s_t_a_t_s(1M), _h_y_l_a_f_a_x(4F)
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128. Page 2                                          (printed 6/24/99)
  129.  
  130.  
  131.  
  132.